home *** CD-ROM | disk | FTP | other *** search
File List | 1995-05-23 | 11.9 KB | 273 lines |
- F I L E D U M P
-
- FILEDUMP is a File/Record - Dump/Viewer/Extract/Search utility that allows
- viewing ANY MS-DOS file in ASCII, HEX, or EBCDIC. Large files up to 1GB and
- records up to 14000 characters are supported. Output can be sent to screen,
- printer, Disk file, .dbf (xBASE) file, or comma delimited file.
- THIS PROGRAM DOES NOT ALTER THE ORIGINAL (Input) FILE IN ANY WAY.
-
- Supported printers are Epson, Okidata, and HP LaserJet.
-
- If Disk, .dbf, or comma delimited output is selected you have the option
- to write non-selected records to a separate file. If the output File Exists you
- can OVER WRITE it, select a New File, or Append to the existing File.
-
- If .dbf output is selected the input file must be a .dbf. This option
- creates a subset of the input file (records) but can not change the structure
- of the .dbf.
- NOTE: This version does NOT handle memo fields. The pointer into the .DBT
- is written with the record, so if the original .DBT file is copied
- with the new name, your application will run.
-
- If Comma Delimited output is selected a table file containing a one record
- per field description is needed, it is of the from XXXXX,YYYYY.
- This is a fast and simple way of converting ascii files into files compatible
- with many different programs. All you do is describe your ascii file and we
- do the rest.
- XXXXX is the staring position in the record of the field
- YYYYY is the length of the data field
- Both have a max length of 5 characters and may have lead zeros, sample file
- DELTEST included. The order of the output fields does not have to be the same as
- the input, and only pieces of the input may be selected, or may be used more
- than once. The order that these items appear in the table dictate the order in
- the output delimited ascii file. If XXXXX is greater than the length of the
- input record a null field is output. If (XXXXX + YYYYYY) - 1 is greater than
- then length of the input record from XXXXX to the end of record will be used.
- When each field is moved to the output all trailing blanks are suppressed. Many
- programs can accept data in the comma delimited ascii format, such as Lotus 123,
- dBase III+ / IV, word processors, etc.
-
- NOTE: If input is a .dbf (xBASE) file remember that the first byte
- (character) of each record is the delete flag.
-
- FILEDUMP was created for users who had a need or were curious about
- the internal file structures or formats used by different software packages.
- Now has Mouse support
-
- Will run as a DOS app under Windows/WFW 3.0/3.1 in window or full screen.
- PIF file included. You will need to use the PIF Editor to change the path to
- point to where you installed the executable. From the Windows Progran Manager
- select Main then PIF Editor then File Then Open -- the Filedump.PIF and change
- Start-Up from C:\UTIL to where you copied FILEDUMP.EXE. If you want to be able
- to Shell out of FILEDUMP you need to change both KB Required & KB Desired to 256
- or more, the amount of KB is based on the program you want to run.
-
- Will run in a DOS window under OS/2 2.1.
-
- INPUT FILE TYPE
- S = Standard file dump -- The file is divided into 80 character pieces.
- Used when file structure is unknown or not one of other listed options.
- This option will work for ANY MS-DOS file. i.e. .EXE .COM
-
- D = .DBF Data Base file
- dBASE III, dBASE III PLUS and dBASE IV and CLIPPER
- Filedump will get the record size from the database. Filedump will then
- ask for the starting record number which maybe 1 thru 325 MB.
- For taking a look into .DBF files without having a full featured database
- program.
-
- F = Fixed length records -- may or may not end with CR LF
- For this option to work correctly ALL records in the file MUST be the
- same size. Filedump will ask for the record size, this maybe 1 thru 14000.
- Filedump will then ask for the starting record number which maybe 1 thru
- 325 MB. Use F option for .DBT (Memo field) files with record size = 512
-
- V = Variable length records -- each record MUST end with [CR] LF.
- This is a standard ASCII file, also works with UN*X files.
-
- Z = Variable length records -- each record ends with X(xx). Where X(xx)
- the record terminator is supplied as a 2 character Hex code by the user.
-
- Maximum record size is 14000 characters for all types except "S"
-
-
- F I L E D U M P M E N U
-
- Esc = Exit Menu to Exit program question.
-
- F2 = Toggle Show All of record or only first line "Short form" -- Default ALL.
-
- F3 = Toggle Display of HEX representation of characters -- Default HEX Off.
-
- F4 = Toggle Display of Count Grid line under data display ex. 1...|....*....|.
- Default No count grid.
-
- F5 = Toggle ASCII/EBCDIC for display (character) representation -- Default ASCII
-
- F6 = Toggle Search mode (Find ALL) -- Locate all occurences of specific data.
- Enter the search arugment (string) in the format A'=ASCII E'=EBCDIC X'=Hex.
- No ending delimitor is used so that the apostrophe can be used in the
- search argument. ex. A'Stan's X'3a0d0a (:/CR/LF)
-
- Enter/Return key only to use a table (file) of search arguments, or a range
- of values.
- Enter Table of values Range of values > user enters a "T" or "R"
-
- The table file may contain up to 500 entries, and use up to 5000 bytes
- of storage, sample file MESSDROP.TXT included. At the end of run
- each element of the table is displayed along with a count of how
- records matched this element. NOTE If a record has more than one
- element in it only the first one is counted.
-
- A range of values, max length of range entry 36 bytes. The high range
- must be greater than the low range, and must be the same length.
- Use Alt F1 to set the starting position. The length is taken from the
- range/search argument (Alt F2 is not needed or used here).
- ex. Enter Low Range Search argument >19000
- Enter High Range Search argument >19154
- If these are zip codes, this will pull all
- Zips >= 19000 and <= 19154
-
- NOTES: All searchs are case sensitive.
- In Hex string a thru f can be enetered in upper or lower case.
- In table (file) input a ; in first position cause line to be
- treated as a comment/remark.
-
- Ctrl F6 = Toggle Search (Find)/First ONLY
- Will search for a match and when successful will go in to normal
- display mode, with the file positioned to the first record that
- matched the value(s)/range.
- NOTE: A table (file) of search arguments may also be used here.
-
- Ctrl F7 = Find NEXT/Display -- Repeat Last/Previous search.
- Used to find next match after a MATCH was found using Ctrl F6.
-
- Alt F1 = Change Starting postion in record to begin search -- Default 1st char.
- Used to limit search, most useful with records where data is in a
- fixed position, as in .dbf files.
- NOTE: When used with .dbf files, the first postion of the record is
- the delete flag, so all starting postions using a structure printout
- must have one added to them.
-
- Alt F2 = Change Field Size / Search area length -- Default entire record.
- Used to limit search, most useful with records where data is in a
- fixed position. If field size is larger than search arugment (string)
- than we will check for an "contains/embedded in" string. If both are
- equal and smaller than field size in input record than we will check
- for "Begins With" search arugment.
-
- Alt F6 = Toggle display of file pointer/line number after Search/Find match
- Used with F6, after each match a line with the file pointer--number
- of bytes into file, and also record/line number into file from where
- you started Search, of record is displayed -- Default is Off.
-
- F7 = Select Search condition Display/Print/Write records that are:
- equal / not equal / until equal / while equal -- to the search argument
- Default condition is equal to, used with F6 and Ctrl F6.
-
- Ctrl F5 = Select "V" or "Z" type records based on record size
- Equal / Not equal / Greater Than / Greater Than or Equal
- Less Than / Less Than or Equal to selected record size
- This option maybe used with F6 (Find All) or Ctrl F6 (Find First)
-
- F8 = Change maxmium number of records to Print/Display/Search/Write
- Default is the entire file. (325000000 records)
-
- F9 = Toggle Generate CR/LF after write of record to disk -- Default is Off.
-
- Alt F7 = Set File Filter -- you may use wildcards -- Default is *.*
- Used to limit the files that are shown -- ex. *.txt
- The system will bring up a display of files based on what the
- File Filter is set to. You then can use the arrow keys to highlight
- a file name and hit return, or if you have a mouse move cursor over
- file name and hit left mouse button. Hit ESC key and you can key in
- file name with PATH and Drive.
-
- Alt F8 = Change Logged drive
- Will display available drives and let you select the new default.
-
- Alt F9 = Change Current Directory -- will display current subdirectory
- and a list available subdirectories -- You then can use the arrow
- keys to highlight a directory and hit return, or if you have a mouse
- move cursor over directory and hit left mouse button. Hit ESC key and
- you can key in new Path Name (works just like DOS CD command) or
- Return (Current Path) to exit
-
- Alt F10 = DOS Shell -- Shell out of progran to DOS. Used to Run another
- program or DOS command.
- If program is unable to shell it will return the DOS error code.
- NOTE: IF run under windows the user will need to change the PIF file
- to get or memory, how much memory is needed depends on the program
- you want to run.
-
- Ctrl F8 = Toggle Fast Screen Write -- Default is On.
-
- Ctrl F9 = Nth Select -- Select every Nth record, range is 1 thru 32000.
- This option maybe used with F6 (Find All) or Ctrl F6 (Find First).
- Default is every 11111th record. If the Nth count is greater than the
- number of records in the file no records will be pulled.
-
- \ = Exit menu to main processing
-
- F10 = Go process new record range
-
-
-
- File Navigation Keys
-
- Up arrow Scrolls screen up one line/record
- Dn arrow Scrolls screen down one line
- PgUp Scrolls up one screen
- PgDn Scrolls down one screen
- Home Moves to top of file
- End Moves to end of file
-
-
-
- D I S C L A I M E R o f W a r r e n t:
-
- This program is supplied AS IS without any warranty, expressed or implied
- of any kind. In no case is Stanley R. Weiss or World Wide Enterprises liable
- for any damages resulting from your use of this program.
-
- Technical support policy:
- Free unlimited mail support to all registered users.
- Fixs, and updates are free for first year.
-
- This program will work with DOS up to and including Ver 6.20, Disk
- partitions > 32MB, Files > 32MB, CD-ROM's, and Novell Networks.
-
- This program require DEVICE=ANSI.SYS statement in your CONFIG.SYS File.
-
- Please sent comments about this program or suggestions for updates to:
- World Wide Enterprises
- 13084 Townsend Road
- Philadelphia PA 19154-1001
- Attn: Stan Weiss
-
-
-
-
-
- TECHNICAL INFORMATION
-
- This program was written and assembled with the Microsoft Macro
- Assembler, Version 5.1 [MASM].
-
-
-
-
-
- PLEASE REGISTER!
-
- If you find this program useful, please send a $15 contribution to
- the address above.
-
-
-
-
-
- DISCLAIMER
-
- This code is released with two restrictions as to its use.
-
- 1. The program must not be modified in any way.
- 2. The program must not be sold.
-
- The author has taken due care in writing this code, and the code is
- supplied as is. The author makes no expressed or implied warranty of
- any kind with regard to this code. In no event shall the author be
- liable for incidental or consequential damages in connection with or
- arising out of the use of this code.
-
-